Skip to content

feat(collab): playstyle suggestion flow (T-041) - #13

Merged
BrandanBurgess merged 32 commits into
mainfrom
integration
Jul 16, 2026
Merged

feat(collab): playstyle suggestion flow (T-041)#13
BrandanBurgess merged 32 commits into
mainfrom
integration

Conversation

@BrandanBurgess

Copy link
Copy Markdown
Owner

T-041: Playstyle suggestion flow (Brief §4 step 22)

Player submits a free-text playstyle suggestion on their own roster row and sees it pending; coach sees a gold badge and an Approve/Dismiss card; approve merges the note onto the profile (visible both roles), dismiss clears it. One pending suggestion per player (409 on a second). All routes scoped, author/team stamped server-side, request models extra=forbid, coach-only endpoints 403 players (11 new backend tests + e2e both viewports incl. three-theme pass). No migration: the playstyle_suggestions table shipped in 0002.

Behavior note (rule 7 flag, reasonable default shipped)

No row-claiming surface exists in the design, so the flow needs a way to know which roster row is "yours": on a player's roster fetch, if exactly one unclaimed row name-matches their display name (case/whitespace-insensitive) and they hold no row yet, it becomes theirs. Never guesses (zero or multiple matches = no-op), idempotent, and replaceable by a designed claim/assignment mechanism later without changing the suggestion API. Also makes the existing "(you)" tag functional.

DoD (Brief §5, Roles and sessions)

  • Suggestion flow round-trips: player submits, sees pending; coach approves; note appears merged on the profile; dismiss clears it (e2e, both viewports)
  • make verify green on integration post-merge (pytest 126, playwright 80 both viewports, em-dash scan, seed validator)

🤖 Generated with Claude Code

BrandanBurgess and others added 30 commits July 16, 2026 02:39
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…T-030)

Whiteboard page (Brief step 16, PNG 01-05/14/34): toolbar, view menu
(zones + thresholds), record/replay, and save into My Patterns, all
persisted through the scoped query layer (backend/app/routers/whiteboard.py)
into the boards and saved_patterns rows (doc 03 4.2/4.3). Delete is
coach-only, enforced server-side (403 for players), and every saved
pattern is author-stamped from the caller's own membership, never a
client-supplied field.

Fixes a real reload bug: the view menu's settings popover floated above
the toolbar and, left open, could visually sit on top of a token (e.g.
the ball's default spot, or any token near the toolbar on a phone-width
board). A drag or click landing there hit the popover instead of the
token, and for a checkbox's label that silently flipped a zone toggle
the user never touched, which then persisted to the boards row on
reload. Fixed by closing the view menu when recording starts (a
deliberate mode switch) and, for phone-width boards where the popover
has no gap in the pitch it can occupy without covering some token,
pinning it to the viewport's top edge instead of floating over the
pitch.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Systematic permission test suite covering every Brief section 3 table
row in both roles, API and UI: backend/tests/test_permissions.py names
each test after its table row (whiteboard, delete-a-pattern, library/
formations/identity, roster/fit-warnings, plus the additive-only and
player-token-gets-403 principles), and e2e/permissions.spec.ts sweeps a
player-role visit across all five pages asserting coach-only controls
and data are absent from the DOM, not merely hidden.

Audit result: no enforcement gaps found. Whiteboard delete, roster CRUD,
and fit_warnings exclusion were already API-enforced from their own
tickets (T-030, T-033); this suite pins that behavior explicitly against
the table rather than leaving it implicit across five separate files.

Two table rows (Suggest own playstyle, Sessions) have no API surface yet
in this codebase state, only their models: marked as named, skipped
tests with a reason, for T-041/T-042 to turn into real assertions rather
than silently omitted.

One known ambiguity is pinned, not changed, per this ticket's own
instruction: the API returns join_code to any team member while the UI
shows it to coaches only (docs/agent/STATE.md open founder question 2).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Player submits a free-text playstyle suggestion on their own roster
profile, sees it pending; coach reviews from a team-wide queue with a
gold badge and an Approve/Dismiss card; approve merges the text into
players.playstyle_note (visible both roles), dismiss clears it with no
merge. New backend/app/routers/suggestions.py enforces every direction
at the API: only a player may submit, and only against their own linked
roster row; only a coach may list the pending queue, approve, or
dismiss (403 otherwise). No new migration: playstyle_suggestions already
exists in the 0002 schema migration.

Player-row linkage (needed for "own profile") did not exist yet before
this ticket; app/routers/roster.py adds a minimal, UI-free claim: on a
player's own GET /api/roster, an unclaimed row whose name uniquely
matches their display_name becomes theirs.
BrandanBurgess and others added 2 commits July 16, 2026 13:04
@BrandanBurgess
BrandanBurgess merged commit 2bd2af3 into main Jul 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant